-A.tra.iri, Inc* 
1312 Crossman Ave. 

P.0. Box 61657 
Sunnyvale, CA 94088 


Dear Atari Customer! 

If you wish to have technical information on your new XL computer, other than the 
following information which we can send you! 

XL Guidelines (eenory changes fron 801 to XL) 

XL Hwwry Hap (general) 

XL New Graphics Hodes 
XL Useful Henory Locations 
XL Indefinable Keys 
XL Port B Changes 


you will need to buy! 

Technical Reference Nuw. 4616355; 029.95 


California sales tax 1.80 
Santa Clara county sales tax 80,15 
TOTAL $31.90 

plus the! 

& Addendum (CO24515-801) 04,95 
California sales tax ,30 
Santa Clara county sales tax 0,02 
TOTAL 05,27 


The Technical Reference Notes include the 400/800 Operating System User's Manual, 
the 400/800 OS Source Listing, and the 400/800 Hardware manual. Most of this is 
directly applicable to the XL computers, and the differences in the Operating Systems 
are explained in the Addendum , At present the XL Source Listing is not available, but 
is scheduled for release second quarter, 1984, 

The above literature may be obtained by sending a check payable to Atari, Inc, for 
the appropriate amount, and a short cover letter naming the items desired, to! 

Atari Customer Relations 
1312 Crossman Ave. 

P.O. Box 61657 
Sunnyvale, CA 94088 

If you have further questions or comments, please feel free to write or call our 
toll-free numbers! (800)672-1404 (inside CA), (800)538-8543 elsewhere. Thank you. 

Sincerely, 

Product Specialist 
Customer Relations 



GUIDELINES 


References are made in the following paragraphs to the Operating System 
User’s Manual which is included with the ATARI Home Computer System 
Technica~RiTerence Notes (CA016555, Rev7”X7copyright 1982 ATARI, 

INC.), XL Addendum (CQ24515-001, Rev. A, copyright 1983). The notes 
can be ordered from your local ATARI Home Computer retailer or through 
ATARI by calling 800-538-8543 (outside California) 800-672-1404 (inside 
California). 

NOTE: Many popular computer magazines and textbooks provide sample 
programs which break some of the guidelines presented below. One common 
example is the provision of so-called "useful POKE locations" for ATARI 
BASIC programmers without any mention of which variables are internal. Do 
not assume that a program will run on an ATARI XL Computer if it uses a 
technique from a published source that breaks any of the following 
guidelines. Use the Operating System User’s Manual as the authoritative 
source if there is any doubt about the legality of a specific programming 
decision. 

Violation of any of the following guidelines could cause a program to 
malfunction on an ATARI XL Computer. Programs written entirely in ATARI 
BASIC which do not use the PEEK or POKE instructions should have no 
compatibility problems. All other programs which do not deliberately attempt 
to violate one of the rules below are probably also compatible. 

Note that the following paragraphs use the convention of preceding 
hexadecimal numbers with a "$". 

1. There are no "spare" locations in the operating system database. 
Memory locations $0000-$007F and $0200-$047F are reserved and 
should not be assigned to user variables or constants. For 
example, programs which assign values to the previously 
unspecified locations $02C9-$02E3 are likely to fail in the XL O.S.. 

2. "User accessible" variables (such as the left margin of text area, 
LMARGN at $0052, and the cursor inhibit, CRSINH at $02F0) have 
retained their original addresses. However, "internal" and 
"temporary" variables may have been moved, so no attempt should 
be made to access them. For example, PBUFSZ, previously at 
$02DF, has been relocated. 

WARNING: NEWROW and NEWCOL, previously at $0060 and $0061, 
respectively, have been relocated. They are internal variables 
even though they are specifically referenced in the ATARI 400/800 
BASIC Reference Manual . 

3. System calls to operating system routines should use only 
"advertised" entry points and vectors. These addresses are 
provided in Appendix J of the Operating System User’s Manual. 
Vectors labeled "for OS internal use only" (such as DlSKIV), or 
found from scanning the operating system listing may have moved 
and should not be used. 



* 
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4. No attempt to detect BASIC, PILOT, or other types of cartridges 
should be made. Since no documented procedures exist for doing 
so, revisions to these cartridges could cause such programs to 
fail. Similarly, no attempt should be made to execute a j um p 
directly into cartridge ROM. 

5. Programs should conform to the interfaces described in the 
Operating System User's Manual with regard to: 

Power up initialization (coldstart). 

RESET initialization (warmstart). 

Interrupt processing. 

System time utilization. 

I/O operations. 

Floating point operations. 

Memory management. 

6. Programs should not rely upon "side effects" of system functions. 

The interface for each operating system function is documented; 
since "bonus" features such as finding a useful constant in a 
register upon return cannot be relied upon, they should not be 
used. 

7. The "initialization values" given in section 6 of the early versions 

of the Operating System User's Manual are not valid for the XL O.S.. 
They sEould not be relied upon. 

8. No attempt should be made to access the hardware register 
PORTB, at memory location $D301 (54017 decimal). Since the two 
game ports formerly controlled by PORTB have been eliminated 
from the XL line, it has been reallocated for other purposes. 

9. System calls to O.S. routines should utilize only "advertised" 
entry points and vectors. These addresses are provided in 
Appendix J of the Operating System User's Manual, and thev fall 
in two address regions: I) $E466-E47P (Rev A/B) for the 
operating system, and 2) $D800-DFFF for the floating point 
package. 

10. The character set definitions are at locations $E000-E3FF and 
$CC00-CFFF for the international character set. 



XL MEMORY MAP 


The following memory map assumes that DOS 2.OS is booted with a graphics 
mode 0 screen in BASIC. 


HEXIDECIMAL 

DECIMAL 

0000-007F 

0-127 

0080-00FF 

128-255 

0100-01FF 

256-511 

0200-05FF 

512-1535 

0600-06FF 

1536-1791 

0700-1CFB 

1792-7419 

1CFC-9C1E 

7420-39966 

9C1F-9FFF 

39967-40959 

A000-BFFF 

40960-49151 

C000-CBFF 

49152-52223 

CC00-CFFF 

52224-53247 

D000-D0FF 

53248-53503 

D100-D1FF 

53504-53759 

D200-D2FF 

53760-54015 

D300-D3FF 

54016-54271 

D400-D4FF 

54272-54527 

D500-D7FF 

54528-55295 

D800-DFFF 

55296-57343 

E000-E3FF 

57344-58367 

E400-FFFF 

58368-65535 


USE 

OS page zero RAM 

user page zero RAM (BASIC) 

6502 stack 

OS RAM 

FREE RAM 

DOS 

user RAM (BASIC) 
display list and screen RAM 
BASIC cartridge 
OS ROM 

OS ROM (intn'l character set) 

GTIA registers 

reserved for future use 

POKEY registers 

PIA registers 

ANTIC registers 

reserved for future use 

OS ROM (floating point package) 

OS ROM (domestic character set) 

OS ROM 


PIA PORTB at 54017 ($D301) is used to control the memory management in 
the XL Computers. Bit 0 controls access to the OS ROM and is normally 
enabled (bit=l). Setting the bit to 0 will disable the OS ROM in the region 
$C000-$CFFF and $D800-$FFFF and enable the RAM. Unless another OS has 
been provided, the system will crash on the next interrupt. 

Bit 7 controls access to RAM in the region $5000-$57FF and is normally 
enabled (bit=l). Setting the bit to 0 will disable the RAM and remap the 
memory access such that the OS ROM is accessed. This provides access to 
the self-test code physically present at $D000-$D7FF. 
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XL MEMORY LOCATIONS 


The following is a list of useful memory locations that are unique to the XL 
Operating System. 


FUNCTION 
KEY REPEAT DELAY 
KEY REPEAT RATE 
KEY CLICK 
HELP KEY 

KEYBOARD USE 
TEXT FINE SCROLLING 
INTL CHAR SET 
OS ROM ID 


LOCATION 

POKE 729,N 

POKE 730,N 

POKE 731,0 
POKE 731,255 
POKE 732,0 
PEEK(732) 


POKE 621,0 
POKE 621,255 

POKE 622,255:GRAPHICS 0 

POKE 622,0:GRAPHICS 0 

POKE 756,224 

POKE 756,204 

PEEK ( 65527 )=221 

PEEK(65528)=87 

PEEK (65527 )=243 

PEEK (65528 )=230 

PEEK(65527)=10 

PEEK (65527 )=11 

PEEK(65527)=1 

PEEK(65527)=2 


DESCRIPTION 

N = # VBLANK INTERVALS 
(DEFAULT = 48) 

N = #VBLANK INTERVALS 
(DEFAULT = 6) 

ENABLE 
DISABLE 
CLEAR 
17 = HELP 

81 = [SHIFT] + HELP 

145 = [CONTROL] + HELP 

ENABLE 

DISABLE 

FINE SCROLL 

COARSE SCROLL 

DOMESTIC (DEFAULT) 

INTERNATIONAL 

400/800 REVISION A 

400/800 REVISION B 
1200XL REVISION A 
1200XL REVISION B 
600XL 
800XL 



O.S. DATA BASE CHANGES FROM REV. B TO XL O.S 


This is a list of the differences in memory usage between the Rev. B 
operating system of the A400/800 and the operating system developed for the 
XL Computers. 


LOCATION REV. B USE 


XL USE 


0000 
0001 
001C 
001D 
001E 
001F 
0036 
0037 
004A 
004B 
0060 
0061 
0062 
0079 
007A 
0233 

0238-0239 

0245 

0247 

0248-026A 

026B 

026C 

026D 

026E 

0288 

028E 

029C 

02BD 

02C9-02CA 

02CB-02CC 

02CD-02CE 

02CF-02D0 

02D1-02D2 

02D3-02D4 

02D5-02D6 

02D7-02D8 

02D9 

02DA 

02DB 

02DC 

02DD 

02DE 

02DF 

02E9 

02F5 

02F6-02F7 

02F8 


reserved 

reserved 

PTIMOT moved (0314) 
PBPNT moved (02DE) 
PBUFSZ moved (02DF) 
PTEMP (deleted) 
CRETRY moved (029C) 
DRETRY moved (02BD) 
CKEY moved (03E9) 
CASSBT moved (03E9) 
NEWROW moved (02F5) 
NEWCOL moved (02F6) 

" (02F7) 

ROWINC moved (02F8) 
CLINC moved (02F9) 
reserved 

tf 


LINBUF (deleted) 

ft 


CSTAT (deleted) 
reserved 
TMPX1 (deleted) 
HOLD5 (deleted) 
reserved 

ft 


f? 


LNFLG 

NGFLAG 

ABUFPT 


LTEMP 

ff 

ZCKAIN 

n 

FKDEF 

n 

PALNTS 

KEYDEF 

n 

LCOUNT 

RELADR 

RECLEN 

reserved 

tf 

CHSALT 

VSFLAG 

KEYDIS 

FINE 

HIBYTE 

NEWADR 

CRETRY 

DRETRY 

RUNADR 

HIUSED 

ZHIUSE 

GBYTEA 

LOADAD 

ZLOADA 

DSCTLN 

ACMISR 

KRPDEL 

KEYREP 

NOCLIK 

HELPFG 

DMASAV 

PBPNT 

PBUFSZ 

HNDLOD 

NEWROW 

NEWCOL 

ROWINC 


for inhouse debugger 
for power-up selftest 
reserved 


loader temp. 

handler loader temp. 

func key def ptr. 

PAL/NTSC flag, 
key def pointer 

loader temp 
loader 

ft 


character set ptr 

fine scroll temp 

keyboard disable 

fine scroll flag 

loader 

loader 

from 0036 

from 0037 

loader 

loader 

loader 

loader 

loader 

loader 

disk sector size 
reserved 
auto key delay 
auto key rate 
key click disable 
HELP key flag 
DMA state save 
from 00 ID 
from 001E 
handler loader flag 
from 0060 
from 0061 
from 0079 



DATA BASE CHANGES FROM REV. B TO XL LINE (cont’d) 


LOCATION 

REV. B USE 

XL USE 



02F9 

tt 

COLINC 

__ 

from 007A 

030E 

ADDCOR (deleted) 

JMPERS 

— 

option jumpers 

0314 

TEMP2 moved (0313) 

PTIMOT 

— 

from 001C 

033D 

reserved 

PUPBT1 

— 

power-up/ reset 

033E 

ft 

PUPBT2 

— 

ft 

033F 

ft 

PUPBT3 

— 

ft 

03E8 

ft 

SUPERF 

— 

screen editor 

03E9 

ft 

CKEY 

— 

from 004A 

03EA 

ff 

CASSBT 

— 

from 004B 

03EB 

ff 

CARTCK 

— 

cart checksum 

03ED-03F8 

ft 

ACMVAR 

— 

reserved 

03F9 

ff 

MINTLK 

— 

n 

03FA 

ft 

GINTLK 

— 

cart interlock 

033FB-03FC 

ff 

CHLINK 

— 

handler chain 



XL NEW GRAPHIC MODES 


The XL O.S. has been enhanced to allow BASIC to establish 4 graphics 
modes that were not available with the 400/800 OS. In BASIC these are 
graphics modes 12-15. 


GRAPHICS MODE 12 


This mode sets up a display list of ANTIC mode 4 which is a 4-color 
character mode. Each character displayed on the screen will occupy the 
same physical space as a mode 0 character, i.e. 4 color clocks wide and 8 
scan lines high. The difference is that mode 0 displays 8 pixels within the 
4 < 2 >1 ? r clocks ’ while mode 12 displays only 4 pixels. The 8-byte shape 
definition in the character set is interpreted as bit pairs in mode 12 as 
opposed to single bits in mode 0. 

Mode 12 will use 40 bytes of screen RAM for each of its 20 mode lines. Four 
mode 0 lines are displayed in the text window. A full 24 mode lines can be 
accessed with GRAPHICS 12+16. 


It is difficult to form a recognizable character in a 4x8 matrix so mode 12 is 
not recommended for use as a text mode. However, because you can display 
4 colors in one "character", it is excellent for animation or background 
patterns using a redefined character set. 


GRAPHICS MODE 13 


This mode sets up a display list of ANTIC mode 5 which is a 4-color 
character mode. Each character displayed on the screen will occupy double 
the physical space as a mode 0 character, i.e. 4 color clocks wide and 16 
scan lines high. Another difference is that mode 0 displays 8 pixels within 
the 4 color clocks, while mode 13 displays only 4 pixels. The 8-byte shape 
definition in the character set is interpreted as bit pairs in mode 13 as 
opposed to single bits in mode 0. 

Mode 13 will use 40 bytes of screen RAM for each of its 10 mode lines. Four 
mode 0 lines are displayed in the text window. A full 12 mode lines can be 
accessed with GRAPHICS 13+16. 


It is difficult to form a recognizable character in a 4x8 matrix so mode 13 is 
not recommended for use as a text mode. However, because you can display 
4 colors in one "character", it is excellent for animation or background 
patterns using a redefined character set. 



GRAPHICS MODE 14 


This mode sets up a display list of ANTIC mode $C which is a 2-color map 
mode with a resolution of 160 across by 192 down. Mode 14 could be 
thought of as mode 6i because each mode line is only 1 scan line high 
whereas mode 6 is 2 scan lines high. 


GRAPHICS MODE 15 

This mode sets up a display list of ANTIC mode $E which is a 4-color map 
mode with a resolution of 160 across by 192 down. Mode 15 could be 
thought of as mode 71 because each mode line is only 1 scan line high 
whereas mode 7 is 2 scan lines high. 


RECAP 


MODE 

TYPE 

COL 

12 

CHAR 

40 

28 

CHAR 

40 

13 

CHAR 

40 

29 

CHAR 

40 

14 

MAP 

160 

30 

MAP 

160 

15 

MAP 

160 

31 

MAP 

160 


ROW 

COLORS 

RAM 

20 

4 

1154 

24 

4 

1152 

10 

4 

664 

12 

4 

660 

160 

2 

4270 

192 

2 

4296 

160 

4 

8112 

192 

4 

8138 



INDEFINABLE KEYS 


There are two tables in ROM that the XL O.S. uses to translate keystrokes 
into AT ASCII values. One table is for the keyboard and the other is for 
the function keys F1-F4. The procedure to redefine a keystroke is relatively 
simple. First, define an area in RAM memory to store two tables. The 
keyboard table requires 192 bytes and the function key table requires 8 
bytes. Second, store the ATASCII code definitions for the keystrokes in 
the new table. Third, change the OS data base variable that points to the 
location of the table. 


KEYBOARD 


The Keyboard is able to generate 64 hardware keycodes. These codes, 0-63 
($00-$3F) are used to index into the keyboard table to find the appropriate 
ATASCII value associated with the keycode. When pressed in conjunction 
with the SHIFT key, the keys generate an additional 64 codes, 64-127 
($40-$7F). When pressed in conjunction with the CONTROL key, the keys 
generate an additional 64 codes, 128-191 ($80-$BF). Therefore, a 192 byte 
table is needed for the keyboard table. The hardware keycodes are as 
follows: 


0 

L 

1 

J 

4 

F2 

5 

K 

8 

O 

9 


12 

RETURN 

13 

I 

16 

V 

17 

HLP 

20 

F4 

21 

B 

24 

4 

25 


28 

ESC 

29 

5 

32 

9 

33 

SPACE 

36 


37 

M 

40 

R 

41 


44 

TAB 

45 

T 

48 

9 

49 


52 

BACKSP 

53 

8 

56 

F 

57 

H 

60 

CAPS 

61 

G 

The 

O.S. data base 

variable KEYDEF 


2 

I 

3 

FI 

6 

+ 

7 

♦ 

10 

P 

11 

U 

14 

- 

15 

= 

18 

C 

19 

F3 

22 

X 

23 

Z 

26 

3 

27 

6 

30 

2 

31 

1 

34 

• 

35 

N 

38 

/ 

39 

ATARI 

42 

E 

43 

Y 

46 

W 

47 

Q 

50 

0 

51 

7 

54 


55 


58 

D 

59 


62 

S 

63 

A 


located at 121-122 ($79-$7A). 


FUNCTION KEYS (1200 XL only) 


The function keys F1-F4 can generate 4 hardware keycodes. When pressed 
in conjunction with the SHIFT key, the keys generate an additional 4 
keycodes. Therefore, an 8 byte table is needed for the function key table. 
When redefining the function keys, do not assign codes 138-141 ($8A-$8D) to 
keys F1-F4 or a system lockup can occur. The O.S. data base variable 
FKDEF is located at 96-97 ($60-$61). 



SPECIAL FUNCTION ATASCII CODES 


Any code in the range 128-145 ($80-$91) will tell the system to perform 
specific function as follows: 


128 

$80 

ignore 

129 

$81 

invert video 

130 

$82 

toggle upper/lower case 

131 

$83 

uppercase lock 

132 

$84 

control lock 

133 

$85 

end of file 

134 

$86 

ATASCII 

135 

$87 

ATASCII 

136 

$88 

ATASCII 

137 

$89 

toggle key click 

138 

$8A 

cursor up, ATASCII 28 ($1C) 

139 

$8B 

cursor down, ATASCII 30 ($1D) 

140 

$8C 

cursor left, ATASCII 31 ($1E) 

141 

$8D 

cursor right, ATASCII 32 ($1F) 

142 

$8E 

cursor home 

143 

$8F 

cursor bottom 

144 

$90 

cursor left margin 

145 

$91 

cursor right margin 


NON-REASSIGNABLE KEYS 


The following keys are not reassignablc: 

BREAK 

SHIFT 

CONTROL 

OPTION 

SELECT 

START 

RESET 

HELP 

CONTROL - FI 
CONTROL - F2 
CONTROL - F3 
CONTROL - F4 


* • <v- 


POETB CHANGES 


w ^ch no longer is connected to gome I/O 
f tunctions which include control ot LED l LED 

2. read enable^ of the the OS ROM's and other functions. To change only one 
single bit at a time within that port the following technique should be used 


Clear A Bit (bit b) 

LDAPORTB 
AND * $FF-b 

STA PORTB .clears only bit b in the port 

Set A Bit (bit b) 

LDAPORTB 
ORA # b 

STA PORTB ;sets only bit b in the port 




XL PORTB ($D301) BIT ASSIGNMENTS 

BIT 

VALUE 

USE " -- 

O 

O 

OS ROM DISABLED. RAM FMART Pn 


1 

OS ROM ENABLED 

to 010 °S ROM * from SCOOO 
to SFFFF except for the region from $DOOO to SD7FF which 

HA ANTTQ? aPPeCi t0 ^ hardware 1/0 cW PS C^TTA POKEY. 

1 

O 

BASIC ENABLED 


1 

BASIC DISABLED. RAM ENABLED 

The memory region mapped to BASIC is from 5BFFF 

2 

O 

LED #1 ON 


1 

LED #1 OFF 

3 

o 

LED #2 ON 


1 

LED #2 OFF 

4 


RESERVED FOR FUTURE USE 

5 


RESERVED FOR FUTURE USE 

6 


RESERVED FOR FUTURE USE 

7 

O 

SELF TEST ROM ENABLED 


1 

SELF TEST ROM DISABLED. RAM ENABLED 
$5000 to°$57^ i0n mapped to ^ 6 3011 t0st ROM « 


c °P ies Port A joystick and paddle values 
and 3^ B shadows - O affects both O and Z stick! affects both 1 


P3<3e is 3 reprint fron the XL supplement 
(COi-^jlS 001) to the -‘tO0/800 Technical Reference 
Notes (C016555) * This supplement pertains to the 
1200XL/6C0XL/800XL computers* 
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